home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / misc / cvarg101.zip / CVARG.DOC next >
Text File  |  1994-12-12  |  3KB  |  75 lines

  1. CVARG V1.01                                                  (c)MicroSource 1994
  2.  
  3. ------------------------------------------------------------------------------
  4. **WARNING**
  5.  
  6. CVARG 1.0 had a bug which when used in SMART mode, it would throw away any
  7. line that did not contain at least one space.  Thus, lines such as labels
  8. or "cls" would not appear in the output file.  This release rectifies that
  9. bug.
  10. ------------------------------------------------------------------------------
  11.  
  12. A utility to convert the old style PCPS arguments (all versions up to and
  13. including V7.80), to the new style supported by V7.90 onwards.
  14.  
  15. CVARG.EXE is a family mode utility which means that it will run under both
  16. DOS and OS/2 in its native mode.
  17.  
  18. Usage:
  19.  
  20.         cvarg [-d] <infile> [outfile]
  21.  
  22.         where:
  23.                 -d        specifies "DUMB" mode.  The default is "SMART"
  24.                           mode.
  25.  
  26.                 infile    is mandatory - the file you want to process.
  27.  
  28.                 outfile   is optional.  If outfile is not specified, the
  29.                           output will be placed into a filename generated
  30.                           by taking the <infile>, stripping any final
  31.                           extent it has, and adding the extent ".new"
  32.  
  33.  
  34. The Story:
  35.  
  36. OK, so you have been using a version of PCPS prior to version 7.90 quite
  37. happily and what do I do?  I introduce a version called 7.90 which changes
  38. all of the arguments around.  How inconsiderate of me!
  39.  
  40. Well, I apologise to those people who have been inconvenienced, but an
  41. change was needed as the arguments had long ago lost any meaning, and I was
  42. running out.
  43.  
  44. To make it up to you (I know this is a little late for some of my users) I
  45. have written a rough utility which will help you migrate from an older
  46. version.
  47.  
  48. CVARG.EXE (or just cvarg to you Unix users) is a utility which is designed
  49. to read through a file and change any old style PCPS arguments to the new 2
  50. character style supported by V7.90 onwards.
  51.  
  52. It has two modes of operation.  The default mode is "SMART" where it will
  53. only modify arguments which are on a line calling pcps or pcpsd.  This mode
  54. is useful for DOS batch files, OS/2 cmd files or Unix script files where
  55. you may be calling other utilities in the same file which have arguments
  56. similar to PCPS and you don't want them modified.
  57.  
  58. For those of you who also want to be able to convert their config and admin
  59. files (pcps.cfg and pcps.adm), CVARG has a "DUMB" mode using the "-d"
  60. argument where it will find any argument in the input file which looks like
  61. an old style PCPS argument and covert it to the new style.
  62.  
  63. DOS and OS/2 users have it easy as all you have to do is run the .EXE file.
  64. Unix users have to compile the source and you will need an ANSI compiler
  65. such as gcc to do that.  Just typing "make cvarg" should work on all
  66. platforms.
  67.  
  68. So that's about it.  I hope this makes life a little easier for someone :-)
  69.  
  70. Blueskies,
  71.  
  72. Paul Carapetis, MicroSource.
  73.  
  74. Internet: P.Carapetis@as03.bull.oz.au
  75.